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Foreword 

This Technical Specification (TS) has been produced by ETSI 3rd Generation Partnership Project (3GPP). 

The present document may refer to technical specifications or reports using their 3GPP identities, UMTS identities or 
GSM identities. These should be interpreted as being references to the corresponding ETSI deliverables. 

The cross reference between GSM, UMTS, 3GPP and ETSI identities can be found under 
http ://webapp . etsi.org/kev/queryform. asp . 
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Foreword 



id , 



This Technical Specification has been produced by the 3 Generation Partnership Project (3GPP). 

The contents of the present document are subject to continuing work within the TSG and may change following formal 
TSG approval. Should the TSG modify the contents of the present document, it will be re-released by the TSG with an 
identifying change of release date and an increase in version number as follows: 

Version x.y.z 

where: 

x the first digit: 

1 presented to TSG for information; 

2 presented to TSG for approval; 

3 or greater indicates TSG approved document under change control. 

y the second digit is incremented for all changes of substance, i.e. technical enhancements, corrections, 
updates, etc. 

z the third digit is incremented when editorial only changes have been incorporated in the document. 



Introduction 



rd , 



The present document is part of a TS-family covering the 3 Generation Partnership Project: Technical Specification 
Group Services and System Aspects; Telecommunication management; as identified below: 

TS 32.351: "Communication Surveillance (CS) Integration Reference Point (IRP): Requirements". 

TS 32.352: "Communication Surveillance (CS) Integration Reference Point (IRP): Information Service (IS)". 

TS 32.353: "Communication Surveillance (CS) Integration Reference Point (IRP): Common Object 

Request Broker Architecture (CORBA) Solution Set (SS)". 

TS 32.354: "Communication Surveillance (CS) Integration Reference Point (IRP): Common Management 

Information Protocol (CMIP) Solution Set (SS)". 

The present document is part of a set of technical specifications defining the telecommunication management (TM) of 
3G systems. The TM principles are described in 3GPP TS 32.101 [1]. The TM architecture is described in 
3GPP TS 32.102 [2]. The other specifications define the interface (Itf-N) between the managing system (manager), 
which is in general the network manager (NM) and the managed system (agent), which is either an element manager 
(EM) or the managed NE itself. The Itf-N is composed of a number of integration reference points (IRPs) defining the 
information in the agent that is visible for the manager, the operations that the manager may perform on this 
information and the notifications that are sent from the agent to the manager. CS (Communication Surveillance) IRP is 
one of these IRPs with special function. 

To ensure the availability and reliability of the management, an automatic surveillance of the communication between 
NM and the managed system are required. CSIRP is defined as a capability to achieve this goal. 
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Scope 



The present document specifies the CORBA Solution Set for the IRP whose semantics are specified in TS 32.352 [6] 
Communication Surveillance IRP: Information Service. 

This Solution Set specification is related to 3GPP TS 32.352 V6.1.X. 



2 References 

The following documents contain provisions which, through reference in this text, constitute provisions of the present 
document. 

• References are either specific (identified by date of publication, edition number, version number, etc.) or 
non-specific. 

• For a specific reference, subsequent revisions do not apply. 

• For a non-specific reference, the latest version applies. In the case of a reference to a 3GPP document (including 
a GSM document), a non-specific reference implicitly refers to the latest version of that document in the same 
Release as the present document. 

[1] 3GPP TS 32.101: "Telecommunication management; Principles and high level requirements". 

[2] 3GPP TS 32.102: "Telecommunication management; Architecture". 

[3] 3GPP TS 32.351: "Telecommunication management; Communication Surveillance (CS) 

Integration Reference Point (IRP): Requirements". 

[4] 3GPP TS 32.312: "Telecommunication management; Generic Integration Reference Point (IRP): 

Information Service (IS)". 

[5] 3GPP TS 32.31 1: "Telecommunication management; Generic Integration Reference Point (IRP): 

Requirements". 

[6] 3GPP TS 32.352: "Telecommunication management; Communication Surveillance (CS) 

Integration Reference Point (IRP): Information Service (IS)". 

[7] 3GPP TS 32.303: "Telecommunication management; Configuration Management (CM); 

Notification Integration Reference Point (IRP): Common Object Request Broker Architecture 
(CORBA) Solution Set (SS)". 

[8] OMG TC Document telecom/98-1 1-01: "OMG Notification Service". 

http://www.omg.org/technology/documents/ 

[9] 3GPP TS 32.300: "Telecommunication management; Configuration Management (CM); Name 

convention for Managed Objects". 



3 Definitions and abbreviations 

3.1 Definitions 

For the purposes of the present document, the terms and definitions given in 3GPP TS 32.101 [1], 3GPP TS 32.102 [2], 
3GPP TS 32.351 [3] and 3GPP TS 32.352 [6] and the following apply: 

IRP document version number string (or "IRPVersion"): see 3GPP TS 32.31 1 [5]. 
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3.2 



Abbreviations 



For the purposes of the present document, the following abbreviations apply: 

CMIP Common Management Information Protocol 

CORBA Common Object Request Broker Architecture 

CS Communication Surveillance 

CSIRP Communication Surveillance IRP 

DN Distinguished Name 

EM Element Manager 

IRP Integration Reference Point 

IOC Information Object Class 

IS Information Service 

NE Network Element 

NM Network Manager 

SS Solution Set 



4 Architectural features 

The overall architectural feature of CSIRP is specified in 3GPP TS 32.352 [6]. 
This clause specifies features that are specific to the CORBA SS. 

4.1 Notifications 

Notifications are sent according to the Notification IRP: CORBA SS (see 3GPP TS 32.303 [7]). 
The contents of the CSIRP notifications are defined in the present document. 

4.2 Syntax for Distinguished Names and versions 

The format of a Distinguished Name is defined in 3GPP TS 32.300 [9]. 

The version of this IRP is represented as a string (see also clause 3 for versions). 



5 Mapping 

5.1 Operation and Notification mapping 

CSIRP: IS 3GPP TS 32.352 [6] defines semantics of operation and notification visible across the CSIRP. Table 1 
indicates mapping of these operations and notifications to their equivalents defined in this SS. 

Table 1 : Mapping from IS Operations and Notification to SS equivalents 



IS Operations/ notification TS 32.352 [6] 


SS Method 


Qualifier 


getHeartbeatPeriod 


get heartbeat period 


M 


setHeartbeatPeriod 


set heartbeat period 


O 


triggerHeartbeat 


trigger heartbeat 


M 


notifyHeartbeat 


push structured event (See clause 6.1) 


M 


getlRPVersion 


get CS IRP versions 


M 


getOperationProfile (see note) 


get CS IRP operations profile 


O 


getNotificationProfile (see note) 


get CS IRP notification profile 


O 


NOTE: This operation is of ManagedGenericIRP IOC specified in 3GPP TS 32.312 [4]. The CSIRP IOC of [6] 
inherits from it. 
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5.2 Operation parameter mapping 

The CSIRP: IS 3GPP TS 32.352 [6] defines semantics of parameters carried in operations across the CSIRP. The 
following tables indicate the mapping of these parameters, as per operation, to their equivalents defined in this SS. 

Table 2: Mapping from IS getHeartbeatPeriod parameters to SS equivalents 



IS Operation parameter 


SS Method parameter 


Qualifier 


hearbeatPeriod 


CSIRPConstDefs::HeartbeatPeriodType 


M 


status 


CSIRPConstDefs::ResultType 

Exception: 

GetHeartbeatPeriod 


M 



Table 3: Mapping from IS setHeartbeatPeriod parameters to SS equivalents 



IS Operation parameter 


SS Method parameter 


Qualifier 


heartbeatPeriod 


CSIRPConstDefs::HeartbeatPeriodType 


M 


status 


CSIRPConstDefs::ResultType 

Exception: 

SetHeartbeatPeriod, InvalidHeartbeatPeriod, conflictingHeartbeatPeriod 


M 



Table 4: Mapping from IS triggerHeartbeat parameters to SS equivalents 



IS Operation parameter 


SS Method parameter 


Qualifier 


managerldentifier 


CSIRPConstDefs::ManagerldentifierType 


M 


status 


CSIRPConstDefs::ResultType 

Exception: 

TriggerHeartbeat, InvalidManagerldentifier 


M 



NOTE: For CORB A SS, the managerldentifier of triggerHeartbeat operation shall be mapped to 
managerReference which is same as what IRPManager used to subscribe notifications [7]. 

Table 5: Mapping from IS getiRPVersion parameters to SS equivalents 



IS Operation parameter 


SS Method parameter 


Qualifier 


versionNumberSet 


Return value of type ManagedGenericlRPConstDefs::VersionNumberSet 


M 


status 


Exception: 
GetCSIRPVersions 


M 



Table 6: Mapping from IS getOperationProf ile parameters to SS equivalents 



IS Operation parameter 


SS Method parameter 


Qualifier 


iRPVersion 


ManagedGenericlRPConstDefs::VersionNumber iRPVersion 


M 


operationNameProfile,ope 
rationParameterProfile 


Return of type ManagedGenericlRPConstDefs::MethodList 


M 


status 


Exception: 

GetCSIRPOperationsProfile, 

ManagedGenericlRPSystem::OperationNotSupported, 

ManagedGenericlRPSystem::lnvalidParameter 


M 
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Table 7: Mapping from IS getNotif icationProf lie parameters to SS equivalents 



IS Operation parameter 


SS Method parameter 


Qualifier 


iRPVersion 


ManagedGenericlRPConstDefs::VersionNumber iRPVersion 


M 


notificationNameProfile,no 
tificationParameterProfile 


Return value of type ManagedGenericlRPConstDefs::MethodList 


M 


status 


Exception: 

GetCSIRPNotificationProfile, 

ManagedGenericlRPSystem::OperationNotSupported, 

ManagedGenericlRPSystem::lnvalidParameter 


M 



5.3 Notification parameter mapping 

The CSIRP: IS 3GPP TS 32.352 [6] defines semantics of parameters carried in notifications. The following table 
indicates the mapping of these parameters to their OMG CORB A Structured Event (defined in OMG Notification 
Service [8]) equivalents. The composition of OMG Structured Event, as defined in the OMG Notification Service [8], 
is: 



Header 



Body 



Fixed Header 

domain_name 

type_name 

event_name 
Variable Header 

f i Iter able_body_fie Ids 
remaining_body 



The following table lists all OMG Structured Event attributes in the second column. The first column identifies the 
CSIRP IS 3GPP TS 32.352 [6] defined notification parameters. 
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Table 8: Mapping for notifyHeartBeat 



IS Parameters 


OMG CORBA 

Structured 
Event attribute 


Qualifier 


Comment 


There is no corresponding 
IS attribute. 


domain_name 


M 


It carries the IRP document version number string. See 
clause 3.1. 

It indicates the syntax and semantics of the Structured Event as 
defined by the present document. 


notificationType 


type name 


M 


This is the ET HEARTBEAT of module of CSIRPConstDefs. 


There is no corresponding 
IS attribute 


event_name 


M 


It carries no information. 


There is no corresponding 
IS attribute. 


Variable Header 






objectClass, 
objectlnstance 


One NV pair of 

filterable_ 

body_fields 


M 


NV stands for name-value pair. Order arrangement of NV pairs is 
not significant. The name of NV-pair is always encoded in string. 

Name of this NV pair is the MANAGED_OBJECT_INSTANCE of 
interface AttributeNameValue of module 
Notification I RPConstDefs. 

Value of NV pair is a string. See corresponding table in 
Notification IRP: CORBA SS [7]. 


notificationld 


One NV pair of 
remaining_body 


M 


Name of NV pair is the NOTIFICATIONJD of interface 
AttributeNameValue of module NotificationlRPConstDefs. 

Value of NV pair is a long. See corresponding table in Notification 
IRP: CORBA SS [7]. 


eventTime 


One NV pair of 

filterable_ 

body_fields 


M 


Name of NV pair is the EVENT_TIME of interface 
AttributeNameValue of module NotificationlRPConstDefs. 

Value of NV pair is IRPTime. See corresponding table in 
Notification IRP: CORBA SS [7]. 


systemDN 


One NV pair of 

filterable_ 

body_fields 


M 


Name of NV pair is the SYSTEM_DN of interface 
AttributeNameValue of module NotificationlRPConstDefs. 

Value of NV pair is a string. See corresponding table in 
Notification IRP: CORBA SS [7]. 


heartbeatPeriod 


One NV pair of 
remaining_body 


M 


Name of NV pair is the HEARTBEAT_PERIOD of interface 
AttributeNameValue of module CSIRPConstDefs. 

Value of NV pair is a CSIRPConstDefs::HeartbeatPeriodType. 


triggerFlag 


One NV pair of 
remaining_body 


M 


Name of NV pair is the TRIGGER_FLAG of interface 
AttributeNameValue of module CSIRPConstDefs. 

Value of NV pair is a CSIRPConstDefs::TriggerFlagType. 


locator 


One NV pair of 
remaining_body 


M 


Name of NV pair is the CHANNELJD of interface 
AttributeNameValue of module CSIRPConstDefs. 
Value of NV pair is a CSIRPConstDefs::channelldType. 

This parameter shall be mapped to an identifier of channel. For 
definition of channel, see OMG Notification Service [8]. 

The CHANNELJD carry the same meaning but may or may not 
carry the same value used by OMG defined Channel ID. 


managerldentifier 


One NV pair of 
remaining_body 


M 


Name of NV pair is the MANAGERJDENTIFIER of interface 
AttributeNameValue of module CSIRPConstDefs. 

Value of NV pair is a CSIRPConstDefs::ManagerldentifierType. 
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CSIRPNotification Interface 



OMG CORBA Notification push operation is used to realise the notification of CSlRPNotif ications. All the 
notifications in this interface are implemented using this push_structured_event method. 



6.1 Method push (M) 



module CosNotifyComm { 

Interface SequencePushConsumer : Notif yPublish { 
void push_structured_events ( 

in CosNotif ication : : EventBatch notifications) 
raises { CosEventComm: :Disconnected) ; 

}; // SequencePushConsumer 

}; // CosNotifyComm 

NOTE 1: The push_structured_events method takes an input parameter of type EventBatch as defined 
in the OMG CosNotif ication module (OMG Notification Service [8]). This data type is the same as 
a sequence of Structured Events. Upon invocation, this parameter will contain a sequence of Structured 
Events being delivered to IRPManager by IRP Agent to which it is connected. 

NOTE 2: The maximum number of events that will be transmitted within a single invocation of this operation is 
controlled by IRP Agent wide configuration parameter. 

NOTE 3: The amount of time the supplier (IRP Agent) of a sequence of Structured Events will accumulate 
individual events into the sequence before invoking this operation is controlled by IRP Agent wide 
configuration parameter as well. 

NOTE 4: IRP Agent may push EventBatch with only one Structured Event. 
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Annex A (normative): 
IDL specifications 

A.1 IDL specification (file name "CSIRPConstDefs.idl") 

// File: CSIRPConstDefs.idl 

#ifndef _CSIRPCONSTDEFS_IDL_ 
#define _CSIRPCONSTDEFS_IDL_ 

// This statement must appear after all include statements 
#pragma prefix "3gppsa5.org" 

/* ## Module: CSIRPConstDef s 

This module contains commonly used definitions for CSIRP. 



*/ 

module CSIRPConstDef s 
{ 

typedef unsigned short HeartbeatPeriodType; 

/* 

If notifyHeartbeat is triggered by NM positively by invoking 

triggerHeartbeat operation, the value of this parameter shall be IRPManager, 

otherwise, it shall be IRP Agent . 

*/ 

enum TriggerFlagType (IRPManager, IRP Agent}; 

typedef string Managerldentif ierType; 

typedef string ChannelldType; 

/* 

It specifies whether the operation is success or failed. 

*/ 

enum ResultType { Success, Failure }; 

/** 

* This block identifies attributes which are included as part of the 

* CommunicationSurveillanceIRP . These attribute values should not 

* clash with those defined for the attributes of notification 

* header (see IDL of Notification IRP). 
*/ 

interface AttributeNameValue 
{ 

const string HEARTBEAT_PERIOD = "HEARTBEAT_PERIOD" ; 

const string CHANNEL_ID = "CHANNEL_ID" ; 

const string TRIGGER_FLAG = "TRIGGER_FLAG" ; 

const string MANAGER_IDENTIFIER = "MANAGER_IDENTIFIER" ; 



#endif // _CSIRPCONSTDEFS_IDL_ 
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A.2 IDL specification (file name "CSIRPSystem.idl") 

// File: CSIRPSystem.idl 

#ifndef _CSIRPSYSYEM_IDL_ 
#define _CSIRPSYSYEM_IDL_ 

# include "ManagedGenericIRP System. idl" 
#include "ManagedGenericIRPConstDef s . idl" 
#include "CSIRPConstDef s . idl" 

// This statement must appear after all include statements 
#pragma prefix "3gppsa5.org" 

/* ## Module: CSIRPSystem 

This module implements capabilities of CSIRP . 



*/ 

module CSIRPSystem 
{ 

/** 

* The InvalidHeartbeatPeriod exception is used when the period 

* value to be set by IRPManager is not a reasonable in IRP Agent ' s 

* implementation. A very short period may cause IRP Agent to 

* send many heartbeat notification in a short time, which may 

* decrease the performance of IRP Agent . To prevent this, 

* IRPAgent may set the lower limit period in its system 

* implemntation . When the period to be set is shorter the 

* lower limit period, IRPAgent may throw this exception 

* and reject to set the period to new value. 

* Note: set the period to zero must be allowed. The behaviour of 

* setting period to zero pis see definition for Period. 
*/ 

exception InvalidHeartbeatPeriod 
{ 

unsigned short periodLowerLimit; 

string reason; 



exception InvalidManagerldentif ier { string reason; }; 
exception Conf lictingHeartbeatPeriod { string reason; }; 

/* 

System fails to complete the operation. System can provide reason 
to qualify the exception. The semantics carried in reason 
is outside the scope of this IRP. 

*/ 

exception GetHeartbeatPeriod { string reason; }; 

exception SetHeartbeatPeriod { string reason; }; 

exception TriggerHeartbeat { string reason; }; 

exception GetCSIRPVersions { string reason; }; 

exception GetCSIRPOperationsProf ile { string reason; }; 

exception GetCSIRPNotif icationProf ile { string reason; }; 

interface CSIRP 

{ 

/** 

* IRPManager invokes this operation to obtain the current 

* heartbeat period. 
*/ 

CSIRPConstDef s : :ResultType get_heartbeat_period ( 

out CSIRPConstDef s : : HeartbeatPeriodType heartbeatPeriod 
) 
raises (GetHeartbeatPeriod) ; 



/* 



IRPManager invokes this operation to set the heartbeatPeriod. 
If the heartbeatPeriod is modified by one IRPManager, a 
notif yHeartbeat notification should be emitted 
immediately to all the subscribed IRPManagers to indicate 
the new heartbeatPeriod. If the heartbeatPeriod is set to 
zero, one notif yHeartbeat notification will be 
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* emitted immediately and no more 

* notifications unless the heartbeatPeriod is modified again. 
*/ 

CSIRPConstDefs : :ResultType set_heartbeat_period ( 

in CSIRPConstDefs : : HeartbeatPeriodType heartbeatPeriod 
) 
raises (SetHeartbeatPeriod, 

Conflict ingHeartbeatPeriod, 

InvalidHeartbeatPeriod, 

ManagedGenericIRP System: : ValueNot Supported, 

ManagedGenericIRPSystem: :OperationNotSupported) ; 

/* 

* IRPManager invoke this operation to trigger ET_HEARTBEAT 

* notification positively. 
*/ 

CSIRPConstDefs: :ResultType trigger_heartbeat ( 

in CSIRPConstDefs : :ManagerIdentif ierType managerldentif ier 
) 
raises (TriggerHeartbeat, InvalidManagerldentif ier) ; 

/** 

* Return the list of all supported CSIRP versions. 
*/ 

ManagedGenericIRPConstDef s : : VersionNumberSet get_CS_IRP_versions ( 

) 

raises (GetCSIRPVersions ) ; 

/** 

* Return the list of all supported operations and their supported 

* parameters for a specific CSIRP version. 
*/ 

ManagedGenericIRPConstDef s : :MethodList get_CS_IRP_operations„prof ile ( 

in ManagedGenericIRPConstDef s : : VersionNumber iRPVersion 
) 
raises {GetCSIRPOperationsProf ile, 

ManagedGenericIRPSystem: : Ope r at ionNot Supported, 

ManagedGenericIRPSystem: : InvalidParameter) ; 

/** 

* Return the list of all supported notifications and their supported 

* parameters for a specific CSIRP version. 
*/ 

ManagedGenericIRPConstDef s : :MethodList get_CS_IRP_notif ication_prof ile ( 

in ManagedGenericIRPConstDef s :: VersionNumber iRPVersion 
) 
raises (GetCSIRPNotif icationProf ile, 

ManagedGenericIRPSystem: : OperationNotSupported, 

ManagedGenericIRPSystem: : InvalidParameter) ; 



#endif // _CSIRPSYSTEM_IDL_ 
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A.3 IDL specification (file name "CSIRPNotifications.idl") 

// File: CSIRPNotifications.idl 

#ifndef _CSIRPNOTIFICATIONS_IDL_ 
#define _CSIRPNOTIFICATIONS_IDL_ 

♦include "CSIRPConstDef s . idl" 

♦include "Notif icationlRPConstDef s . idl" 

♦include "Notif icationlRPNotif ications . idl" 

// This statement must appear after all include statements 
♦pragma prefix "3gppsa5.org" 

/* ♦♦ Module: CSIRPNotifDef s 

This module contains the specification of all notifications of CS IRP Agent. 

*/ 

module CSIRPNotif ications 

{ 

/** 

* Constant definitions for the FileReady notification 

*/ 

interface notifyHeartbeat : Notif icationlRPNotif ications : :Notify 

{ 

const string EVENT_TYPE = "notifyHeartbeat"; 

/** 

* This constant defines the name of the period property, 

* which is transported in the f ilterable_body fields. 

* The data type for the value of this property 

* is CSIRPConstDef s : : HeartbeatPeriodType . 
*/ 

const string HEARTBEAT_PERIOD = CSIRPConstDef s :: AttributeNameValue :: HEARTBEAT_PERIOD; 

/* 

* This constant defines the name of the 

* channelld property, 

* which is transported in the f ilterable_body 

* fields. 

* The data type for the value of this property 

* is CSIRPConstDef s: : ChannelldType . 
*/ 

const string CHANNEL_ID = CSIRPConstDef s :: AttributeNameValue :: CHANNEL_ID; 

/* 

* This constant defines the name of the 

* triggerFlag property, 

* which is transported in the f ilterable_body 

* fields. 

* The data type for the value of this property 

* is CSIRPConstDef s : : TriggerFlagType . 
*/ 

const string TRIGGER_FLAG = CSIRPConstDef s :: AttributeNameValue :: TRIGGER_FLAG; 

/* 

* This constant defines the name of the 

* managerldentif ier property, 

* which is transported in the f ilterable_body 

* fields. 

* The data type for the value of this property 

* is CSIRPConstDef s : :ManagerIdentif ierType . 
*/ 

const string MANAGER_IDENTIFIER = CSIRPConstDef s :: AttributeNameValue : :MANAGER_IDENTIFIER; 

}; 
}; 

♦endif // _CSIRPNOTIFICATIONS_IDL_ 
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